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part |: Introduction and operation 


hotkeys keyboard 


with |8 freely programmable keys 





Design by B. Stuurman 


What’s this, a professional-looking keyboard with no legends on the keycaps? This 
is intentional, so that you can choose the function performed by each key. It’s even 
possible to assign a complete set of keystrokes to a single key. In part | of this 
article, we discuss the communications between a normal keyboard and a PC, 
describe how a hotkeys keyboard can very cleverly worm its way into this process, 
and conclude with a complete description of how to use the hotkeys keyboard. In 


part 2 next month, we will look at the technical details. 


One of the annoying features of many 
Windows programs is that a whole series 
of keys must be pressed to invoke certain 
commands. Consider PageMaker, for 
example: to use the magnifying glass, 
which happens all the time, you have to 
first press the Shift key, then the Alt key 
and finally the F7 key. This means that 
you have to hold all three keys down at 
the same time. Think also of the special 
characters, for which you have to first 
press the Alt key and then enter a three- 
digit or five-digit number using the 
numeric keypad. 

All of this is no longer necessary with 
the hotkeys keyboard. You can program it 
for each application with the key combi- 
nations that you use most often, upload 
this information to the hard disk, and 
download it again whenever you want to 
use it. 


Templates 


Since the functions of the keys of the 
hotkeys keyboard depend on the applica- 
tion with which they are used, it does not 
make any sense to have any legends on 
the keycaps. The layout of the keyboard 
is designed such that it is very easy to 
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Figure |. A template with the ‘name’ of each key is necessary so that you can 


program the keys. 


use templates with it. The function of 
each key can be marked on the template 
next to the key. The name of the associ- 
ated hotkeys file stored on the hard disk 
can also be written on the template. This 
makes it very easy to load the proper 
hotkeys file for a particular application. 

Even though the hotkeys do not have 
any fixed functions, they still have to 
have names so that they can be pro- 
grammed. We have chosen to name them 
using the hexadecimal numbers 0 - 9, a 
—f, 10 and 11. This amounts to eighteen 
numbers. The hotkeys keyboard actually 
has 16 keys, but two more ‘keys’ can be 
formed by simultaneously pressing the 
bottom-most keys of the left-hand part 
(10) or the right-hand part (11). This yields 
a total of 18 keys. 

When the hotkeys keyboard is 
switched on for the very first time, the 
names and functions are assigned to the 
keys. This is because the program ‘sees’ 
that the EEPROM in which the key 
strings are stored is empty, and so it 
copies a table from the ROM to the EEP- 
ROM. Even at this stage, a template is 
necessary to mark the names of the keys, 
so that you can identify the key that you 
want to program. Figure 1 shows this 
template. You can use a photocopier to 
enlarge it to the specified size, and then 
glue it to a thin piece of cardboard. After 
this, you have to cut out the openings for 
the keys. Full-sized versions of the tem- 
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plate in several different file formats are 
also located on the diskette for this pro- 
ject. You can use this template as a 
model for making your own templates. A 
graphics program such as Windows 
Draw or CoreDRAW is very suitable for 
this purpose. 


Communications between 
a PC keyboard and a PC 


The communications between a standard 
PC keyboard and a PC are more compli- 
cated than you might initially assume. 
This is because the keyboard not only has 
to send data to the PC, but the PC can 
also send data to the keyboard. Let’s con- 
sider an example. 

If the Caps Lock key on the keyboard 
is pressed, the keyboard sends the ‘make’ 
code for this key (58;;) to the PC. The PC 
responds to this by setting the associated 
bits in the keyboard status register. After 
this, the PC sends the keyboard a com- 
mand to switch on the Caps Lock LED 
(Dy, 04y). The keyboard responds with 
an Ack(knowledge) character (FA;;) after 
each byte. Once all the data are received, 
the keyboard switches on the Cap Locks 
LED. Try the following experiment: press 
the Caps Lock key, and note that the 
Caps Lock LED is illuminated. Now 
unplug the keyboard connector from the 
PC, wait a little while and plug it in 
again. The Caps Lock LED on the key- 


board will be off, since the keyboard has been reset. 
Now press a key, such as ‘m’, and what do you see 
on the monitor? That’s right, it’s an ‘M’, because 
the Caps Lock status bit in the PC has not been 
changed. 

Each key on the PC keyboard has its own indi- 
vidual code. When the key is pressed, the keyboard 
sends this code, which is called the ‘make code’, to 
the PC. When the key is released, the same code is 
again sent to the PC, but this time the ‘break code 
prefix’ (FOp) is added in front of the code. 

For example, the make code of the left Shift key 
is 11}. If this key is pressed, the keyboard sends 
11y to the PC. If the Shift key is held pressed, the 
keyboard sends a whole series of 114 codes to the 
PC, since the repeat code is the same as the make 
code. When the Shift key is released, the keyboard 
sends FOy, 11y to the PC. This is a very important 
piece of information. The only thing that the key- 
board sends to the PC is a make code when a key 
is pressed and a break code when a key is released. 

Now we know how to make an upper case let- 
ter. All we have to do is to first send the make code 
of the Shift key, followed by the make and break 
codes of the letter in question, and finally the break 
code of the Shift key. If we know that the make 
code of the ‘m’ key is 3Ay, we could program 
hotkey 0 with following string of codes: 


Ilar Sap; P0pgs Saxe Fim lly 


And indeed, if we now press key 0 of the hotkeys 
keyboard, we will see an ‘M’ appear on the screen. 

All this means that we need to know the make 
codes of the keys on the PC keyboard in order to be 
able to program the hotkeys keyboard. The diskette 
for this project includes a table that lists all the rel- 
evant keys and their associated make codes (see 
also the summary in the article ‘PC keyboard 
encoding’ in the February 2000 issue of Elektor 
Electronics). However, the hotkeys keyboard can 
also tell you itself which code belongs to a partic- 
ular key, as we will explain shortly. 

You may wonder why we referred to the ‘rele- 
vant keys’. The original keyboards that were deliv- 
ered with PCs had a block of ten function keys to 
the left of the alphanumeric keys. These keyboards 
had 84 keys. Later on, there came keyboards with 
the function keys in a row across the top and some 
additional keys, such as the cursor keys. These are 
called ‘extended’ keyboards. The make codes for 
the ‘extended’ keys are different from the ‘basic’ 
make codes, in that they are preceded by an addi- 
tional code, such as E1y or EOy. This is not all that 
important, but it is nice to know that the hotkeys 
keyboard can also deal with this. 


Sending codes to the PC 


We now know how to make the strings that we 
want to send to the PC, but we don't yet know how 
this is supposed to happen. The PC keyboard 
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Command summary 


keybeep? 

This is a switch (alternate-action) command that controls whether 
or not the hotkeys keyboard emits a beep whenever a hotkey is 
pressed. 


repeat? 
This is a switch command that enables or disables the hotkey 
repeat function. 


reseep? 

This command resets the hotkeys to their initial states. In other 
words, the default table is copied from the ROM to the EEPROM. 
In the initial state, the function of each key is its name. 


scankb? 

The hotkeys keyboard decouples the PC keyboard from the PC 
and then listens to the PC keyboard. If a key is pressed on the PC 
keyboard, the hotkeys keyboard displays the string that it has 
received on the monitor after the key has been released (see Fig- 
ure 4). The’ scankb’ mode can only be exited by pressing hotkey 
0! (Note: since a certain minimum number of instructions must be 
executed to receive each bit, the clock period of the PC keyboard 
may not be less than 80 us.) 

zox 


è HotKeys - HyperT erminal 
File Edit View Call Transfer Help 





command? 
scankb 

hot O=quit! 
key? 

FO 5A 

5A FO 5A 
29 FO 29 

09 FO 09 

66 FO 66 

21 PO. 21 


escaped! 





4 > 
Connected 00:00:22 Auto detect Auto detect SCROLL [CAPS |NUM |Car 4 





Figure 4. The ‘scankb’ command in action. The first two 
codes, ‘FO 5A, are caused by releasing the Enter key. 
Following this, the following keys were pressed and released 
in turn: Enter, Space, F!0, Backspace and Control. You can 
‘escape’ from this command using hotkey 0. 


volume? 
This command allows the key beeps to be set loud or soft (if they 
have been enabled). 


rtest? 

This is a utility command to check whether values of the divider 
resistors of the hotkeys keyboard are within the allowed toler- 
ances (this is discussed in part 2). 


key? 

This command has two options. If only the ‘name’ of a hotkey is 
supplied as a parameter, the make and break codes assigned to 
that key are displayed (see Figure 5). If the ‘name’ of the hotkey 
is followed by one or more hexadecimal bytes (that is, with two 
hexadecimal characters per byte) separated by spaces, these bytes 
are accepted as the new string to be assigned to that hotkey. It is 
not necessary (nor is it even possible) to enter the break codes, 


since these are generated by the hotkeys keyboard itself in the 
reverse order of the make codes. There are |28 bytes of EEP- 
ROM available to store the strings, and to make efficient use of 
this memory only the make codes are stored. The code ‘QOH’ is 
stored between pair of strings, which means that it is prohibited 
to enter this code as part of a string. The strings are assigned 
dynamically; there is not a fixed number of bytes reserved for 
each hotkey. If the total size of the strings (plus the separator 
characters) exceeds the amount of available memory, this is 
reported and the string is not stored. 


ioj x! 


è HotKeys - HyperT erminal 
File Edit View Call Transfer Help 
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command? 
key 0 
11 69 7A 70 FO 70 FO 7A FO 69 FO 11 


command? 
key 0 12 1c 
programming 
done! 


command? 
key 0 
12 1C FO 1C FO 


command? 

key 0 ff 14 05 
programming 
done! 


f0 05 fO 14 fd 16 fO 16 


command? 
key 0 
FF 14 05 FO 05 FO 14 FD 16 FO 16 





A 


> 


4 
Connected 00:00:22 Auto detect Auto detect 





Figure 5. The ‘key’ command in action. Hotkey 0 is first pressed 
to display the string assigned to it. Hotkey O is then programmed 
with a different string, which is displayed on the following line. 
Finally, hotkey O is programmed with the ‘free format’ string In 
the text. The ‘fd’ character provides a delay of 250 ms. 


The ‘key’ command also allows a hotkey string to be ‘literally’ 
assigned to a hotkey. In this case the string must begin with the 
code ‘ffy’, which can be easily remembered as ‘free format’. 
Such a string must contain the break codes as well as the make 
codes. Everything is written literally to the EEPROM. When the 
hotkey in question is pressed, the entire string is output. It is even 
possible to incorporate a delay in a free-format string. The ‘fdp’? 
code (which you can remember as ‘function delay’) provides a 
delay of 250 ms. For example, suppose that a particular program 
allows you to open a gateway to DOS by holding down Control 
and pressing the Fl key. This causes the option *1?to DOS: 0’ 

to appear. This means that the ‘I’ key must be pressed to go to 

DOS. This whole scenario can be assigned to a single hotkey in 

the form of a free-format string. Since you know (by now) that 

‘Contr’= 14, ‘FI’=05,, en ‘l’=16,4, you can program hotkey 0 

for this purpose as follows: 


key O ff 14 05 fO 05 fO 4 fd 16 fO 16 


The ‘fd,’ code thus provides a delay of 250 ms before the code 
for the ‘I’ key is output. 


^d? 

The program for the hotkeys keyboard includes Xmodem proto- 
cols (with CRC) for sending and receiving hotkey files. If you want 
to save a hotkey file on the hard disk, you can select the Transfer 
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menu in HyperTerminal and then the Receive File option. After this 
you must select a folder and select Xmodem as the protocol. You 
will then be asked to give a name to the received file. After you 
click on OK, the file will be copied to the hard disk (including the 
key beep, repeat and volume settings). In order to make it easier 
to recognise hotkey files, they are assigned the suffix ‘HOT’. 

The Xmodem protocol can however only receive data. In other 
words, if you want to download a hotkey file from the hard disk to 
the hotkeys keyboard, the initiative must come from the hotkeys 
keyboard (which will receive the file). Since the hotkeys keyboard 


sends its data to the PC in serial form. 
The protocol is synchronous, which 
means that the data bits are transferred 
under the control of a clock signal. This 
means that the data transmission timing 
is not critical. In practice, you can find 
keyboards with clock periods ranging 
from 70 us to 120 us. Figure 2 shows the 
serial data transfer format. In the rest 
state, the data and clock lines are both 
high, since the PC and the keyboard both 
have open-collector outputs and there 
are pull-up resistors at both ends. The 
transmission begins with a start bit (‘0’), 
which is followed by the data bits DO 
through D7, then a parity bit (uneven) 
and finally a stop bit (‘1’). The data must 
be stable on the negative edge of the 
clock. From Figure 2, you can also see 
that the changes in the level of the data 
signal occur when the clock signal is 
high. The make code of the Return key 
(5A;;) is shown for illustration in this dia- 
gram. 

The hotkeys microcontroller has send 
and receive routines for this data trans- 
fer format. After it receives a byte, the 
PC needs a certain amount of time to 
process it, and the keyboard is not 
allowed to send any data during this 
time. The PC indicates this to the key- 
board by pulling the clock line low. This 
occurs during the eleventh clock inter- 
val. Once the PC is again free to receive 
data, it lets the clock line go high. Nat- 
urally, the same thing applies in reverse 
to the hotkeys keyboard. After it has 
sent a byte, it must wait until the PC 
has released the clock line before send- 
ing the next byte. On the other hand, if 
the hotkeys keyboard receives data from 
the PC keyboard, it can hold the clock 
line to the PC keyboard low so that it 
has time to put the scan codes in its 
buffer. Once it is finished with this, it 
can allow the clock line to go high 
again. 

Just to avoid any confusion, we should 
note that when the PC sends data to the 
keyboard, the clock signal is supplied by 
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ca. 90 us 
1 2 3 4 


normally wants to upload a file to the hard disk, it is necessary to 
first ‘prime’ it to receive a file before activating the ‘Send’ option 
in HyperTerminal. This is the function of the ‘^d’ (Ctrl d) com- 
mand. First press this key combination, then select Transfer in the 
Hyper Terminal menu bar and select Send File. Then select the 
name of the file to be sent and press the Send button. To initiate 
the actual transfer, you must now press hotkey I. 


This causes a command summary to be displayed on the monitor. 


6 7 8 9 10 11 


ook | | | LE LJ LJ LI LILI LILI 


start=0 DO D1 D2 


D4 D5 D6 D7 Par =odd stop = 1 


return = 5A | | | | | | | | 


0 0 1 0 


1 0 1 0 1 1 
002006 - 1 - 12 


Figure 2. The serial data transfer format that the PC keyboard uses to send information to 


the PC. 


the keyboard. This is thus a different 
transmission format! 


Operating instructions 


In The Advanced Programmer's Guide 
from Ashton-Iate, it is suggested that you 
should first write the operating instruc- 
tions before you start programming. This 
sounds a bit strange, since how can you 
write the operating instructions for some- 
thing that does not yet exist! Neverthe- 
less, it is a very good idea, since it forces 
you to carefully think about the program 
you want to produce before you start writ- 
ing it. In fact, you have to think about the 
program so much that once you have 
drawn up the operating instructions, you 
have just about mapped out the actual 
program. 

We can now carry on with the operat- 
ing instructions for the hotkeys keyboard, 
and leave the description of the hardware 
to next month. 


Connecting the hotkeys keyboard to your 
system is very simple. Plug the cable 
with the male DIN connector in the key- 
board socket of the PC, and insert the 
plug from the PC keyboard in the match- 
ing connector of the hotkeys keyboard. 
The hotkeys keyboard thus sits between 
the PC keyboard and the PC. In addition, 
you will need a serial extension cable to 


connect the hotkeys keyboard to a serial port of the 
PC. A 9-pin female D-type connector is provided for 
this at the back of the circuit board. 

All signals from the PC keyboard are simply 
passed through the hotkeys keyboard to the PC, 
with the understanding that the clock and data sig- 
nals pass through low-impedance analogue 
switches located on the controller circuit board of 
the hotkeys keyboard. The hotkeys keyboard also 
taps its power from the supply lines for the PC key- 
board. 

Under normal circumstances, the hotkeys key- 
board does not interfere with the communications 
between the PC keyboard and the PC. It only takes 
action in two situations: 


1. If a hotkey is pressed, the hotkeys keyboard 
breaks the connection between the PC keyboard 
and the PC and sends the make codes of its key 
to the PC. When the hotkey is released, the 
break codes are sent. The circuit is however 
Smart enough to monitor the clock line, so it 
knows when it has to wait. Finally, it makes 
itself invisible again by closing the analogue 
Switches. 


2. The hotkeys keyboard also breaks the connection 
between the PC keyboard and the PC when a 
‘scankb’ command is being executed. In this 
case, however, it waits for a key on the PC key- 
board to be pressed. When the key is released, 
the hotkeys keyboard displays the received scan 
code string on the screen. 
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TETTERE r Configure the selected COM port for accompanying text box. Here we can 
File Edt View Cal Transfer Help 19200, 8, n, 2. It is usually necessary to make two comments: 
ole als ala save these settings and restart HyperTer- 1. The hotkeys keyboard contains an 
minal in order to make the new settings interactive command processor. Once 
effective. An older terminal emulator pro- you have typed a command, including 
command? 
5 gram such as Procomm can also be used, any parameters, and finished by press- 
e but Windows 98 does not work very well ing Enter, the hotkeys keyboard inves- 
repeat with DOS programs (Procomm ‘sees’ the tigates the entire command line and 
eaa a serial port only after the diagnostic data returns a clear error message if neces- 
volume for the COM port in question has been sary. If there is no error in the com- 
ieee requested in the ‘Modems’ configuration mand line, the command is executed. 
panel). Note that the Backspace and Delete 
Now that everything is installed and keys have no effect; if you have to ‘bail 
the terminal emulator program is run- out’ of the program you can press the 
ning, it is possible to communicate with Esc key. 





(amass OOS ans daa [Aas dae SCROLL [APS NUM rz the hotkeys keyboard. Press the Enter 
key, and the hotkeys keyboard will 
answer with ‘command?’. If you want to 
know what commands are supported by 
the hotkeys keyboard, press *?’ followed 
by Enter. The hotkeys keyboard responds 
by displaying its complete command set 
on the screen (see Figure 3). 

As you can see, the hotkeys keyboard 
employs only lower-case letters, and the 
same thing applies to the user. Upper- 
case letters are forbidden, even for hexa- 
decimal numbers! 

The commands are all explained in the 


2. The hotkeys keyboard will work prop- 
erly even without a serial connection 
to a COM port. However, in this case it 
is not possible to communicate with 
the hotkeys keyboard, and it is not pos- 
sible to change the key string table ‘on 
the fly’. 

Now you know nearly everything about 

what the hotkeys keyboard can do. All 

that’s missing is the hardware, which we 

will examine next month in part 2. 

(002006-1) 


Figure 3. The command set of the hotkeys 
keyboard. 


A serial communications link is necessary between 
the hotkeys keyboard and a COM port of the PC in 
order for the PC to communicate with the hotkeys 
keyboard. In addition, there must be a terminal 
emulator program present in the PC, such as the 
HyperTerminal program belonging to Windows. 
With a standard Windows installation, you will find 
HyperTerminal under Start > Programs > Acces- 
sories > HyperTerminal. 
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I CONSTRUCTION GUIDELINES i 
| Elektor Electronics (Publishing) does not provide parts and components ponents in the correct position? Has correct polarity been observed? Have | 
| other than PCBs, fornt panel foils and software on diskette or Ic (not nec- the powerlines been reversed? Are all solder joints sound? Have any wire y 


. l : bridges been forgotten? 
| essarily for all projects). Components are usually available form a number If voltage levels have been given on the circuit diagram, do those mea- l 











I ram Nea brown-red-brown-gold = 120 Q, 5% 
| Faultfinding. If the circuit does not work, carefully compare the populated yellow-violet-orange-gold = 47 KQ, 5% 
board with the published component layout and parts list. Are all the com- 


J of retailers — see the adverts in the magazine. sured on the board match them — note that deviations up to +10% from | 
| a the specified values are acceptable. J 
Large and small values of components are indicated by means of one of 
Í the following prefixes : Possible corrections to published projects are published from time to time | 
I in this magazine. Also, the readers letters column often contains useful | 
i oe = ne ce = ee comments/additions to the published projects. i 
peta) = emto) = 10- 
l T (tera) = 1012 p (pico) = 10-12 The value of a resistor is indicated by a colour code as follows. l 
| G (giga) = 109 n (nano) = 10-9 | 
| M (mega) = 106 w (micro) = 10-6 I 
k (kilo) = 103 m (milli) = 10-3 
| h (hecto) = 102 e (Cemi) = 104 | 
I da (deca) = 10! d (deci) = 10-! l 
T A I 
, In some circuit diagrams, to avoid confusion, but contrary to IEC and Bs i 
recommandations, the value of components is given by substituting the rel- 
I evant prefix for the decimal point. For example, I 
l 3k9 = 3.9kQ apie el ile color 1st digit 2nd digit mult. factor tolerance | 
| Unless otherwise indicated, the tolerance of resistors is +5% and their rat- black £ 0 = e: - 
ing is 4-4 watt. The working voltage of capacitors is > 50 V. brown 1 1 x10! +1% 
I red 2 2 x 102 +2% I 
l l l l orange 3 3 x103 - | 
In populating a pcs, always start with the smallest passive components, ellow 4 4 x 104 = 
| puia a SE p y i 
that is, wire bridges, resistors and small capacitors; and then Ic sockets, green 5 5 x 105 +0,5% 
| relays, electrolytic and other large capacitors, and connectors. Vulnerable blue 6 b x106 | 
j semiconductors and Ics should be done last. violet 7 i i 
D l oe ue: grey 8 8 
| Soldering. Use a 15-30 W soldering iron with a fine tip and tin with a resin white 9 9 | 
g ) 8 le up 
I core (60/40) Insert the terminals of components in the board, bend them gold es 5 I 
Į slightly, cut them short, and solder: wait 1-2 seconds for the tin to flow silver | 
i smoothly and remove the iron. Do not overheat, particularly when solder- none i 
ing Ics and semiconductors. Unsoldering is best done with a suction iron 
or special unsoldering braid. Examples: I 
I 
I 
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